home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir39 / daybk0_2.zip / DAYBREAK.DOC next >
Text File  |  1993-02-28  |  8KB  |  216 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                                                 |                                                                |
  24.                                                        DayBreak |                                                       DayBreak |
  25.                      Day/date Command Line Substitution Utility |                     Day/date Command Line Substitution Utility |
  26.                                                    Version 0.02 |                                                   Version 0.02 |
  27.                                              User Documentation |                                             User Documentation |
  28.                                                                 |                                                                |
  29.                                                            1993 |                                                           1993 |
  30.                                         Dr J's Amazing Software |                                        Dr J's Amazing Software |
  31.                                                                 |                                                                |
  32.                                                                 |                                                                |
  33.        DayBreak v0.02          -1-
  34.  
  35.  
  36. COPYRIGHT & DISCLAIMER
  37. DayBreak is copyright (C) 1993 by Dr J's Amazing Software.
  38.  
  39. DayBreak is distributed as ShareWare, you are expected to register the
  40. program for a nominal fee if you find it useful and continue to use it
  41. beyond a reasonable trial period.  You are at liberty to distribute this
  42. program.
  43.  
  44. Unregistered versions of DayBreak will not function after June 3, 1993
  45.  
  46. Registered users will recieve a personalised copy of DayBreak for their
  47. own use as well as free upgrades to the program and periodic details of
  48. other products from Dr J's Amazing Software.  Registered versions may not be
  49. distributed.
  50.  
  51. DayBreak is guaranteed to take up diskspace and nothing more.  It has been
  52. tested under MS-DOS 4.01, 5.00 and 4Dos 4.00 and found to function as
  53. detailed in this document.  Operation in other environments is at your own
  54. risk.
  55.  
  56. The use of DayBreak is at your own risk, the author of DayBreak accepts
  57. no responsibility for damages arising from the use of DayBreak either directly
  58. or indirectly.
  59.  
  60.  
  61. INTRODUCTION
  62. DayBreak is designed to insert day, month and/or year
  63. specific information into a DOS command line prior to execution.  While
  64. there are other programs that will do this, Ben Baker's DAYNBR being the
  65. best known, to me they seemed limited in what they could accomplish.
  66. Other programs just insert the Julian day-of-year number, but there are
  67. times when you'd like to use the day of the week, the month or even the year
  68. in various commands.  DayBreak can handle all of these and will substitute
  69. the desired data into a command line before executing it.
  70.  
  71.  
  72.  
  73. INSTALLATION
  74. Unpack the distribution archive and place DayBreak.exe anywhere on your
  75. DOS path.  What could be simpler?
  76.  
  77.  
  78. OPERATION
  79. Correct commandline syntax is:
  80. DayBreak </switch> command arg_1 arg_2 .... arg_n
  81. Switch is indicated by '/' or '-'
  82. The four valid switches are: /D-x   /Dx   /x   /-x
  83.  
  84. /Dx: substitutes date of next day x, where x = day of week.
  85. 0 = Sunday, 1 = Monday .... 6 = Saturday.
  86. e.g. /D3 will assume *next* Wednesday (unless today is that day)
  87.  
  88. /D-x: Substitutes date of previous day x, where x = day of week.
  89. e.g. /D-0 will assume *last* Sunday (unless today is that day)
  90. Note: -0 is not the same as 0 and gives you last Sunday.  0 assumes next
  91. Sunday.
  92.  
  93. D must be between -6 and 6 inclusive.
  94.  
  95. /x: X is numeric value for number of days to move forward.
  96. e.g. /4 uses date four days hence.
  97.        DayBreak v0.02          -2-
  98.  
  99. /-x: X is numeric value for number of days to move back.
  100. e.g. /-1 uses yesterday's date.
  101.  
  102. X can be any valid integer value between -32,768 and 32,768, so -365 for
  103. this day last year is valid.
  104.  
  105. DayBreak does not process wildcards, but leaves them for the actual program
  106. being executed to handle.  You should determine in advance how programs will
  107. handle wildcards.
  108.  
  109. TOKENS
  110. DayBreak uses tokens to substitute the desired information into any DOS
  111. command line and is the heart of DayBreak's modus operandi. Tokens are
  112. always enclosed between @ signs.
  113.  
  114. Supported tokens are:
  115. @dd@    Day of month (01-31)
  116. @d3@    Day (SUN, MON...SAT)
  117. @dnr@    Day number in week (0 = Sunday, 1 = Monday...6 = Saturday)
  118. @###@    Day of year.  Jan 1 = 001.... Dec 31 = 365 (or 366)
  119. @##@    Last two digits of day of year number
  120. @#@    Last digit of day of year number
  121. @mm@    Month (01-12)
  122. @m3@    Month (JAN, FEB...DEC)
  123. @yy@    Year (93)
  124. @y4@    Year (1993)
  125.  
  126. Tokens must be in lower case and more than one token may be in any command
  127. line.  The same tokens may be used multiple times in the one command line.
  128.  
  129. EXAMPLES
  130.  
  131. DayBreak /-1 Arj m -r LOG@m3@@yy@ *.log
  132.  
  133. This will execute Arj and move all files *.log into an archive LOGMMMYY.ARJ.
  134. I execute this on the first of each month to package all the log files on
  135. my BBS, On February 1 it will create the archive LOGJAN93.ARJ.  The -1
  136. ensures the correct month and year.  You could execute this on the last day
  137. of the month without any switch.
  138.  
  139.  
  140. DayBreak /d5 Arj a FLYNODE.J@##@ FLYNODE.@###@
  141.  
  142. This will archive the FlightNet nodelist for day ### into an archive
  143. FLYNODE.J##.  With the switch /D5 DayBreak assumes the date of the next
  144. Friday, starting with the current day, if it is a Friday then today's date
  145. is used.  On Feb 5, 1993 the result will be to pack FLYNODE.036 into
  146. FLYNODE.J36.  DayBreak can then be called again to hatch this file to
  147. FlightNet nodes.
  148.  
  149.  
  150. SUPPORT
  151.  
  152. You can contact the author as follows:
  153.  
  154.  via NetMail to either 3:800/857@fidonet or 48:152/102@flytenet
  155.  
  156.  via snail mail
  157.  PO Box 598
  158.  Nairne
  159.  SA   5252
  160.  Australia
  161.  
  162.        DayBreak v0.02          -3-
  163.  
  164. Or by logging onto:
  165.  The Cockpit BBS
  166.  (08) 388 0188
  167.  24 hours a day, up to v.32
  168.  
  169. DayBreak is always available for file request from 3:800/857@fidonet using
  170. the magic filespec DAYBREAK.
  171.  
  172.  
  173. REGISTRATION
  174.  
  175. Registration is required for DayBreak to function beyond June 3, 1993.  The
  176. low level of response to requests for registration of other Dr J products
  177. has forced the decision to limit future releases in this manner.
  178.  
  179. Registration is AUS $10.  Cheques should be made payable to J. Harding
  180.  
  181. Please fill in the registration form and mail it to
  182.  J Harding
  183.  PO Box 598
  184.  Nairne
  185.  SA   5252
  186.  AUSTRALIA
  187.  
  188. Your personalised copy of DayBreak will be sent to you as soon as your
  189. registration is processed.  It can be delivered by mail (Air Mail for
  190. overseas orders) or crashed directly to any fidonet address.
  191.  
  192. ====================== CUT HERE ======================================
  193. DayBreak Registration Form
  194.  
  195. Name:_________________________________________________________________
  196.  
  197. Location or BBS Name:_________________________________________________
  198.  
  199. Postal Address:_______________________________
  200.  
  201.                _______________________________
  202.  
  203.                _______________________________
  204.  
  205.                _______________________________
  206.  
  207.                _______________________________
  208.  
  209. Please send me my copy of DayBreak in the following manner:
  210.  
  211. Mail on disk:   [ ]    Disk size   [ ] 5.25"   [ ] 3.5"
  212.  
  213. Via E-Mail to my FidoNet Address:  [ ]   Address_____________________
  214.  
  215. ======================================================================
  216.